From: Lars Magne Ingebrigtsen <larsi@gnus.org>
Date: Sat, 2 Jul 2011 21:38:19 +0000 (+0200)
Subject: * display.texi (Showing Images): Mention the point of sliced images (bug bug#7836).
X-Git-Tag: archive/raspbian/1%29.2+1-2+rpi1~1^2~324^2~3158
X-Git-Url: https://dgit.raspbian.org/%22http:/www.example.com/cgi/%22https:/www.github.com/%22bookmarks:///%22http:/www.example.com/cgi/%22https:/www.github.com/%22bookmarks:/?a=commitdiff_plain;h=8de57a16cf9c58c5d6183f0e0ab60265c5b2845c;p=emacs.git

* display.texi (Showing Images): Mention the point of sliced images (bug bug#7836).
---

diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog
index c64f2d2f2e3..e02b9598a38 100644
--- a/doc/lispref/ChangeLog
+++ b/doc/lispref/ChangeLog
@@ -1,3 +1,8 @@
+2011-07-02  Lars Magne Ingebrigtsen  <larsi@gnus.org>
+
+	* display.texi (Showing Images): Mention the point of sliced
+	images (bug bug#7836).
+
 2011-07-02  Eli Zaretskii  <eliz@gnu.org>
 
 	* variables.texi (Defining Variables, Void Variables)
diff --git a/doc/lispref/display.texi b/doc/lispref/display.texi
index 069b3c91d7b..6d19d73545e 100644
--- a/doc/lispref/display.texi
+++ b/doc/lispref/display.texi
@@ -4700,10 +4700,17 @@ it a @code{display} property which specifies @var{image}.  @xref{Display
 Property}.
 @end defun
 
+@cindex slice, image
+@cindex image slice
 @defun insert-sliced-image image &optional string area rows cols
 This function inserts @var{image} in the current buffer at point, like
 @code{insert-image}, but splits the image into @var{rows}x@var{cols}
 equally sized slices.
+
+If an image is inserted ``sliced'', then the Emacs display engine will
+treat each slice as a separate image, and allow more intuitive
+scrolling up/down, instead of jumping up/down the entire image when
+paging through a buffer that displays (large) images.
 @end defun
 
 @defun put-image image pos &optional string area